The copyright of TMagicMacros Component is owned by Niels Vanspauwen (further referred to as the author), (C) 1998.
Permission to use, copy, modify, and distribute this trialversion and its documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appears in all copies and
that both the above copyright notice and this permission notice appear in supporting documentation.
This software is made available "as is", and THE AUTHOR DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,WHETHER IN AN ACTION OF CONTRACT, TORT (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.
2. WHAT SHOULD BE IN THE ZIP
----------------------------
The ZIP file should contain following files:
TRIALVERSION:
Component files:
InfoForm_f.Dcu
InfoForm_f.Dfm
Lzh.Dcu
MagicMacros.Dcu
PEForm_f.Dcu
PEForm_f.Dfm
Progress_f.Dcu
Progress_f.Dfm
TMM_Trial.Dcu
TMM_Trial.Dcr
Demo Projects:
Macro_rec.dpr
Macro_rec_f.pas
Macro_rec_f.dfm
SimpleEdit.dpr
SimpleEdit.vhf
SimpleEdit.hlp
SimpleEdit_f.Pas
SimpleEdit_f.dfm
Tour.mcr
Help files:
Readme.Txt
MagMcr2.Hlp
MagMcr2.Cnt
MagMcr2.Kwf
Tagger Utility:
Tagger.Exe
Tagger.Hlp
Registration tool:
Register.Exe
Register.Hlp
REGISTRED VERSION WITHOUT SOURCES:
Component files:
InfoForm_f.Dcu
InfoForm_f.Dfm
Lzh.Dcu
MagicMacros.Dcu
PEForm_f.Dcu
PEForm_f.Dfm
Progress_f.Dcu
Progress_f.Dfm
TMM_Comp.Dcu
TMM_Comp.Dcr
Demo Projects:
Macro_rec.dpr
Macro_rec_f.pas
Macro_rec_f.dfm
SimpleEdit.dpr
SimpleEdit.vhf
SimpleEdit.hlp
SimpleEdit_f.Pas
SimpleEdit_f.dfm
Tour.mcr
Help files:
Readme.Txt
MagMcr2.Hlp
MagMcr2.Cnt
MagMcr2.Kwf
Tagger Utility:
Tagger.Exe
Tagger.Hlp
REGISTER VERSION WITH SOURCES:
Component files:
InfoForm_f.Pas
InfoForm_f.Dfm
Lzh.Pas
MagicMacros.Pas
PEForm_f.Pas
PEForm_f.Dfm
Progress_f.Pas
Progress_f.Dfm
TMM_Comp.Pas
TMM_Comp.Dcr
Demo Projects:
Macro_rec.dpr
Macro_rec_f.pas
Macro_rec_f.dfm
SimpleEdit.dpr
SimpleEdit.vhf
SimpleEdit.hlp
SimpleEdit_f.Pas
SimpleEdit_f.dfm
Tour.mcr
Help files:
Readme.Txt
MagMcr2.Hlp
MagMcr2.Cnt
MagMcr2.Kwf
Tagger Utility:
Tagger.Exe
Tagger.Hlp
3. INTRODUCTION
---------------
Use the TMagicMacros component to add full macro-support to your application in a snap !
It features recording and playback of mouse- and keyboard events and comes with lots of events to ensure smooth integration in your app.
TMagicMacros features:
- Recording and playing of macro's.
- Looping of macro playback.
- 9 different playback speeds.
- Text-only playback.
- Show or hide mousemovements during playback.
- Automatically adapts playback speed to the speed of the PC.
- Show infoboxes to inform users.
- Relative journaling: the macro automatically adapts to different positions of windows, buttons, toolbars, etc.
- Automatic adaption to different screenresolutions.
- Full VisualHelp file support, without writing one line of code!
As you may have noticed, the word "automatically" appears very often in the description above. This means TMagicMacros is very powerful, yet easy to use. Just set the desired options in the Object Inspector during designtime, implement some eventhandlers (optional) and add a minimum of code to your application and that's it ! Full macro-support in a snap !
Use TMagicMacros to:
- Give the users of your app the possibility to record and playback their own macros to avoid doing the same thing over and over again.
- Make a demo of your application: just record a macro which clearly illustrates how your app works, add a few infoboxes with some extra explanation here and there and distribute a version of your program which automatically plays the macro on startup. As simple as that !
- Make VisualHelp files: don't tell people how to use your program, *show* them !
Two demo projects are included, which shows how easy it is to use TMagicMacros.
4. INSTALLATION INSTRUCTIONS
----------------------------
The TMM_Comp.Pas (or TMM_Trial.Pas for the trialversion) file contains the component definition. This file should be added to your component-library (as always, make a backup of your current library-file before adding a new component)
The other .Pas files are NOT components (and therefor don't have to and can't be linked in your component-library), but they're used by the MacroMagic.Pas file. Keep these files in the same directory.
I've also included the possibility to install context-sensitive for TMagicMacros. To install MagMacr2.Hlp into Delphi's helpsystem, follow these steps:
1. Copy the helpfile (MagMcr2.hlp and MagMcr2.cnt) into the same directory as the component.
2. Copy the keyword file (MagMcr2.kwf) to your Delphi\Bin directory.
3. Run HelpInst. (Comes with Delphi, located in Delphi\Help\Tools).
4. Open you Delphi Header File (delphi.hdx, normally located in Delphi\Bin)
5. Click on Add Keyword File and select the MagMcr2.kwf file.
6. If there is any keywordfile that is not found (indicated in the right column of the grid), click Options - Search Paths and locate the wanted .kwf files.
7. Now click "Save" and wait while HelpInst merges the keyword files into the header.
Context-sensitive help for TMagicMacros is now installed!
Note: you may have to restart Delphi before the context-sensitive help is activated.
5. GETTING MORE INFORMATION
---------------------------
TMagicMacros comes with a complete WinHelp file. This help file describes all the properties, methods and events of TMagicMacros clearly. Look for MagMcr2.Hlp in the ZIP.
6. REGISTERING TMAGICMACROS COMPONENT
-------------------------------------
TMagicMacros is shareware, which means that you are free to use and test this component for as long as you want. The trialversion is fully functional but it only works if the IDE is running (which does NOT mean you have to run your projects from the integrated debugger!)
If you like what you're seeing, please register the component for as little as $25 (version without sources) or for $100 (version with full sources).
There are a few ways you can register TMagicMacros:
***** VERY VERY VERY VERY IMPORTANT!!! *****
Whatever method you choose, ALWAYS provide me with a VALID E-MAIL ADDRESS!! I will send you the registered component through e-mail, and e-mail only (I can not send the component on floppy, for several reasons).
If you do not supply an e-mail address, I will not be able to send the component to you!!
I use a shareware registration service called Kagi to process the orders. Kagi is a large, professional company, so you can be sure that your personal information is safe with them. You pay using any method you prefer: cash, US cheque (no local currency please!), MasterCard, Visa, DinnerClub, etc, etc...
You can register online from my website: http://magicmacros.8m.com All transimisions are secure so your creditcard information is protected.
If you don't like to register online, you can also use snailmail or fax. I've included a special registration program called "Register.Exe" for this purpose. The usage of Register is very simple, just run it and fill in the required information. If need any help, check out the helpfile: register.hlp.
For the latest information and prices, please visit my website: http://magicmacros.8m.com
If you are unable to reach my website, you can send an e-mail to the following address: Niels.Vanspauwen@Kagi.Com
7. CONTACTING THE AUTHOR
------------------------
If you have any problems or questions, please first check out the helpfile that comes with TMagicMacros. Every feature, method, property and event is explained there in detail, with examples and I've even included two demoprojects in the ZIP, in order to make the usage of the component as clear as possible.
If that doesn't help, you can check the FAQ at my website: http://magicmacros.8m.com
If all else fails, you can reach me by e-mail at: Niels.Vanspauwen@Kagi.Com
8. CREDITS
----------
The TMagicMacros component, the demo projects, the helpfiles and the Tagger Utility were written by Niels Vanspauwen.
The Lzh.Pas file is based on the Japanese C version of Noverember 29th,1988. LZSS coded by Haruhiko OKUMURA. Adaptive Huffman Coding coded by Haruyasu YOSHIZAKI. Edited and translated to English by Kenji RIKITAKE. Translated from C to Turbo Pascal by Douglas Webb (2/18/91). Update and bug correction of TP version (4/29/91). Added Delphi exception handling May 9th, 1996 by Danny Heijl (Danny.Heijl@cevi.be).
My eternal gratitude goes out to my girlfriend Martine for her love and support and for putting up with me, spending so much time behind my computer.
Special thanks go out to my beta-testers for bugreports, tips and suggestions. The beta-testers are (in alphabetical order): Brian Armstrong, Erik B.Berry, Marc Di Meo (a.k.a. Hellfire), Bruce Glover (a.k.a. Private), Andreas Hase, Ben Hicks, Tim Hofstee, Bernd Schachinger and George Shin.
Thanks for fruitful discussions and suggestions: Freddy Biets and Gerrit Wolsink.
